home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr47 / wasm223.zip / SLEEPER.DOC < prev    next >
Text File  |  1993-05-04  |  8KB  |  188 lines
  1.  
  2.  
  3.                                      SLEEPER
  4.                                   by Eric Tauck
  5.                                 October 25, 1989
  6.  
  7.      SLEEPER is a memory resident utility that automatically blanks a
  8.      screen after a certain period of keyboard inactivity or upon command
  9.      by the user. This is useful in preventing screen 'burn-in' or hiding
  10.      the contents of the screen from prying eyes.  SLEEPER requires a
  11.      standard IBM PC or compatible computer running PC or MS DOS version
  12.      2.0 or higher and uses about 750 bytes of memory.
  13.  
  14.      NOTE: there are different versions of SLEEPER for different adapter
  15.      types.  Only run the version of SLEEPER that matches the computer's
  16.      adapter.  See the end of this document for more information on the
  17.      different versions of SLEEPER.
  18.  
  19.      SLEEPER must be made resident before it can blank the screen
  20.      automatically. This is done by running SLEEPER from the DOS command
  21.      line.  A single numeric parameter may be specified to set the amount
  22.      of time (in seconds) before blanking the screen.  If the parameter is
  23.      absent, SLEEPER will blank the screen after five minutes (300
  24.      seconds).
  25.  
  26.      Once installed (i.e. made resident), SLEEPER constantly monitors the
  27.      keyboard and system clock.  If no key is pressed for the specified
  28.      amount of time, SLEEPER blanks the screen.  SLEEPER will make the
  29.      screen visible the moment any key is pressed.  The pressed key is NOT
  30.      absorbed by SLEEPER, but is passed through to the system.
  31.  
  32.      The resident SLEEPER can be controlled by running the SLEEPER program
  33.      or with special keystroke commands.  The keystroke commands will only
  34.      work when an application is expecting keyboard input.  For instance,
  35.      during a long compile, the keyboard commands will not work because
  36.      most compilers don't poll the keyboard.
  37.  
  38.      If the screen is explicitly blanked (by running SLEEPER with the H
  39.      option or pressing ALT-CTRL-H when resident), it will remain so until
  40.      it is explicitly un-blanked (by running SLEEPER with the V option or
  41.      pressing ALT-CTL-V when resident) or by resetting the timer (by
  42.      running SLEEPER with the R option or pressing ALT-CTRL-R when
  43.      resident).
  44.  
  45.      The screen can be blanked without installing SLEEPER by running it
  46.      with the H option.  The screen will remain blank until SLEEPER is run
  47.      again using the V option.
  48.  
  49.      SLEEPER will blank the screen in all text and graphics modes.  When
  50.      the screen is blank, the computer continues to operate normally.  You
  51.      can continue to type commands to an application or DOS, even if you
  52.      are unable see what you're typing.
  53.  
  54.                         Non-Resident Command Line Options
  55.                         ---------------------------------
  56.  
  57.      SLEEPER ?
  58.  
  59.        Display a brief help screen.
  60.  
  61.  
  62.  
  63.      SLEEPER nnn
  64.  
  65.        Install SLEEPER with a timer value of 1 to 3600 seconds.  If this
  66.        number is absent, SLEEPER will be installed with a value of 300
  67.        seconds (five minutes).  Note that the number 'ticks' are displayed
  68.        upon installation, not seconds.  Ticks occur at about 18.2 per
  69.        second and are what SLEEPER actually uses to measure the passage of
  70.        time.
  71.  
  72.      SLEEPER H
  73.  
  74.        Force the screen hidden (i.e. blank).  The screen will remain hidden
  75.        until the screen is forced visible with the V option below.
  76.  
  77.      SLEEPER V
  78.  
  79.        Force the screen visible.  Only useful if the screen has been forced
  80.        hidden with the H option above.
  81.  
  82.                           Resident Command Line Options
  83.                           -----------------------------
  84.  
  85.      SLEEPER ?
  86.  
  87.        Display a brief help screen.
  88.  
  89.      SLEEPER nnn
  90.  
  91.        Set a new timer value.  The range of legal values is 1 to 3600, the
  92.        same as when installing SLEEPER.  As when installing, the number of
  93.        ticks (not seconds) are displayed.
  94.  
  95.      SLEEPER H
  96.  
  97.        Force the screen hidden (i.e. blank).  The timer is disabled and the
  98.        screen remains blank until it is forced visible or the timer is
  99.        reset.
  100.  
  101.      SLEEPER R
  102.  
  103.        Reset the timer.  The internal timer is reset as if a key was
  104.        pressed.  If necessary, the timer is restarted and the screen is un-
  105.        blanked.
  106.  
  107.      SLEEPER T
  108.  
  109.        Force a timeout.  The internal timer is set so the screen will blank
  110.        after one second.  Once the screen is blanked, it will be un-blanked
  111.        as soon as any key is pressed.
  112.  
  113.      SLEEPER U
  114.  
  115.        Uninstall SLEEPER.  This command removes SLEEPER from memory.
  116.      Sometimes
  117.        SLEEPER cannot be removed if another TSR has been installed after
  118.        SLEEPER.
  119.  
  120.  
  121.  
  122.      SLEEPER V
  123.  
  124.        Force the screen visible.  The timer is disabled and the screen
  125.        remains visible until it is forced hidden or the timer is reset.
  126.  
  127.                            Resident Keyboard Commands
  128.                            --------------------------
  129.  
  130.      ALT-CTRL-H
  131.  
  132.        Force the screen hidden.  Same as SLEEPER H above.
  133.  
  134.      ALT-CTRL-R
  135.  
  136.        Reset the timer.  Same as SLEEPER R above.
  137.  
  138.      ALT-CTRL-T
  139.  
  140.        Force a timeout.  Same as SLEEPER T above.
  141.  
  142.      ALT-CTRL-V
  143.  
  144.        Force the screen visible.  Same as SLEEPER V above.
  145.  
  146.                                    Usage Notes
  147.                                    -----------
  148.  
  149.      SLEEPER is usually installed automatically in the AUTOEXEC.BAT file
  150.      when the computer is booted up.
  151.  
  152.      Controlling SLEEPER from the command line is typically done from batch
  153.      files to modify SLEEPER before loading an application and then to
  154.      restore SLEEPER once the application has terminated.  Since SLEEPER
  155.      cannot detect input from a mouse or joystick, you may want to force
  156.      the screen visible before running an application which primarily uses
  157.      a mouse or joystick for input.
  158.  
  159.      SLEEPER doesn't work well with all applications, particularly
  160.      applications that are timing or video sensitive (like games for
  161.      instance).  If you think there is a conflict between an application
  162.      and SLEEPER, you can always uninstall SLEEPER before running the
  163.      application and then reinstall SLEEPER once the application has
  164.      terminated.
  165.  
  166.      SLEEPER monitors the shift keys (SHIFT, ALT, and CTRL) as well as all
  167.      of the 'normal' keys.  A shift key can be used to restore a blanked
  168.      screen without passing a keystroke to the currently executing program.
  169.  
  170.      Releasing a pressed key has a the same effect as pressing a key, thus
  171.      if a key was being held down when SLEEPER decided to blank the screen,
  172.      the screen will be un-blanked as soon as the key is released.
  173.      Similarly, if you use the forced timeout keystroke command (ALT-CTRL-
  174.      T) and hold the ALT or CTRL keys down for more than one second, the
  175.      screen will be un-blanked as soon as you release either key.
  176.  
  177.  
  178.  
  179.      SLEEPER only works with VGA adapters, however two special versions of
  180.      SLEEPER, SLEEPERE and SLEEPERM, are provided that should work with EGA
  181.      and monochrome adapters respectively.  SLEEPERE blanks the screen by
  182.      setting the palette registers to black.  Because setting the palette
  183.      registers is not an instantaneous operation, keystrokes can be lost
  184.      when blanking or restoring the screen.  Only run the version of
  185.      SLEEPER that matches the computer's adapter, though it should be okay
  186.      to run SLEEPERE on a VGA adapter.
  187.  
  188.